pp108 : Installing an Authentication Plugin

Installing an Authentication Plugin

This topic describes the procedure to install an authentication plugin in a Process Platform service group.

Before you begin this task:
You must have an authentication plugin written in Java and packaged in a .jar file. The .jar file must be present on the system where Process Platform is running.


If you want to authenticate against an unsupported backend, you can write your own custom authentication plugin. The procedure to do this is described in Writing an Authentication Plugin.

  1. On CUSP > My Applications, click (System Resource Manager) and select the service group you want to add the authentication plugin to. The System Resource Manager window appears.
  2. Double-click the <service container> to which you want to add your custom authentication plugin. The Properties - <service container> dialog box appears.
  3. Click JRE Configuration tab to open the Java Runtime Environment configuration pane.
  4. Add the location to your custom authentication plugin .jar file to the classpath field.
  5. Click to save your changes.
  6. On CUSP > My Applications, click (LDAP Explorer). The LDAP Explorer window appears.
  7. Navigate to Cordys > <orgainzation> and click the service group that should have the authenticator configured. The Properties - <service group name> window appears.
  8. Click the button in the bussoapnodeconfiguration row. The String (xml) - Edit XML for string window appears.
  9. Copy the following XML in the XML edit field inside the <configuration> tag.
    <configuration> ... <authenticator implementation="com.example.authenticator.class">
            <com.eibus.web.soap.Validator> com.eibus.web.soap.LDAPValidator </com.eibus.web.soap.Validator>
        </authenticator>
    </configuration>
    


    Note: Replace com.example.authenticator.class with the name of your Authenticator class. The implementation field states which class is used as Authenticator. In this case, the property com.eibus.web.soap.Validator is set to the given value.

  10. Click to save your changes.
  11. Click to close the Properties - <service group name> window.
  12. Click to close the LDAP Explorer window.
  13. Restart the service. To do this:
    1. On CUSP > My Applications, click (System Resource Manager). The System Resource Manager window appears.
    2. Right-click <service container> and click Restart.
  14. Repeat Steps 4 - 13 for every service you want to configure.
    An authentication plugin is implemented.

Related tasks

Writing an Authentication Plugin